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PREFACE 


The AMC LINK8000 product is primarily intended for linking relocatable 
code assembled by MACRO8000. LINK8000 is considered a_ supporting 
product for MACRO8000 users. The LINK8000 directives, statement 
structure, and general design are similar to MACRO8000. For instance, 
the distinction between PROGRAM and MODULE is identical in MACRO8000 
and LINK8000. 


MACRO8000 and LINK8000 together support development of programs for 
both the AmZ8001 and AmZ8002 processors. 


The notations used in this manual are: 


UPPERCASE In syntax indicates a name that is specified as 
shown. 
lowercase In syntax indicates that a name or value must be 


supplied by the user. 


eee In syntax indicates that an item can be repeated. 
° In examples indicates that some part of the program 
; is not shown. 


Important related information can be found in the: 
Manual Number 


AMC MACRO8000 AmZ8000 Assembler User’s Manual 00680119 


NOTE 

The information in this publication is intended to 
be accurate in all respects. However, Advanced 
Micro Computers disclaims responsibility for any 
errors and any consequences resulting from errors. 
This product is intended for use as described in 
this manual. | 
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CHAPTER 1 
OVERVIEW OF LINK8000 


LINK8000 takes several modules of relocatable AmZ8000 code and combines 
them into a single module of either absolute code or relocatable code. 
Absolute code can be targeted for either the AmZ8001 or the AmZ8002. 
The relocatable output module can be either a library or a module to be 
used in a later linking operation. The relocatable module can also be 
used as input for a user-defined loader. 


LINK8000 requires 64K bytes of memory, either on an AmSYS 8/8 or System 
29. LINK8000 itself requires more than 30K, AMDOS uses about 8K, and 
the rest is symbol table space and working storage. 


1-1. THE AmZ8000 PROGRAMMING ENVIRONMENT 


The AmZ8000 programming environment is determined by the answer to one 
fundamental question: 


Does the source program or program module use any segmented 
addresses? 


A segmented address is represented by a pair of numbers, a /-bit 
segment number and a l6-bit offset; it is stored in a 32-bit register 
pair. A non-segmented address, on the other hand, is represented by a 
single, 16-bit number; it is stored in a word register. Segmented 
addresses can be used only by the AmZ8001, while non-segmented 
addresses can be used by either the AmZ8001 or the AmZ8002. (A bit in 
the FCW of the AmZ8001 controls the type of addresses it uses. See the 
AmZ8001/2 Instruction Set Manual for more details.) 


The user assembles a program with MACRO8000 before calling the linker. 
When the assembler is invoked, the S option controls the programming 
environment. If the S option is not chosen, the output code will use 
exclusively non-segmented addresses. If the S option is chosen, the 
output code may use segmented addresses as well as non-segmented 
addresses, and the code must be run on an AmZ8001. If the S option is 
not chosen, the code will usually be run on an AmZ8002 (although with a 
user-supplied loader it is possible to run the code on an AmZ8001). 
Hereafter in this manual and in the MACRO8000 User’s Manual, we will 
use such phrases as "targeted for the AmZ8001" or "AmZ8001 code" to 
mean that the assembler S option has been chosen, and conversely, we 
will use "targeted for the AmZ8002" or "AmZ8002 code" to mean that the 
S option has not been chosen. Chapter 5 of the MACRO8000 User’s Manual 
contains a discussion of segmented an non-segmented addresses and how 
users can specify which kind is generated by the assembler. 


If the S option is chosen, relocatable code is produced, but either 
relocatable or absolute code may be produced if the S option is not 
chosen. Relocatable code must be further processed by LINK8000, which 
takes one or more relocatable files and combines them into a single 
absolute file or into another relocatable file. Figure 1-1 illustrates 
all the possible paths from source file to absolute file. 


An AmZ8000 program typically consists of one or more modules. The 
module is the smallest programming unit that can be assembled 
separately. Each module is assembled using the assembler option 0, 
which generates relocatable code, and each module exists as a single, 
relocatable file. 


Programmers may subdivide modules into program segments; for example, a 
module might be partitioned into a code segment and a data segment. 
Segments cannot be assembled separately; they are simply used to 
partition modules. However, once several modules have been assembled, 
each containing several segments, LINK8000 can be used to rearrange and 
combine the segments in an arbitrary manner. A segment is thus the 
smallest programming unit that can be manipulated by the linker. 


1-2. LINKING OPERATION 


When the user calls the linker, the user provides linker directives 
that tell the linker what to do. The linker directives tell the linker 
what input to use, what to do with the input, what addresses to assign, 
and what output to produce. The linker begins processing by accepting 
linker directives. The user can: 


Save the linker directives in a directive file (default file type 
-DIR) that is read by the linker. 


Enter linker directives interactively at the console. 


The linker determines the general type of linking operation from the 
first directive. The user can specify a: 


PROGRAM directive to link relocatable code into absolute code for 
downloading to an AmZ8001 or AmZ8002 processor. 


MODULE directive to combine relocatable code into a= single 
relocatable module to be used in later linking operations. 


LIBRARY directive to create a user library of relocatable code that 
can be used in later linking operations. 


ROMLIB directive to create a ROM library that contains only a 
directory of globals associated with absolute code in hex or binary 
(AMC Bin) file form (i-e., pre-defined entry points). 7 
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Figure 1-1. Source to Absolute File Paths 
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The linker accepts input files for the linking operation. The 
relocatable files can be modules containing program segments. The 
relocatable files can also be combined relocatable modules. or 
libraries created in previous linking runs. The FILE directive accesses 
relocatable files as input to the linker. 


The linker also accepts directives that indicate the libraries to be 
searched in the linking operation. The libraries have the default file 
type .ZRL and are either regular libraries or ROM libraries. The SEARCH 
directive accesses libraries for satisfying externals. | 


The linker resolves symbol references among the program segments 
contained in the relocatable modules. This step is the main function of 
the linker. A single global symbol, such as an entry point, might be 
referenced in one or more other program segments as an external. In all 
cases, the linker matches the externals to the global. Certain 
externals might not be satisfied among the segments in the modules but 
might be satisfied by routines in a library. The linker first attempts 
to satisfy external references among the segments in the modules and 
then checks any specified libraries. The user can also directly assign 
absolute addresses to unsatisfied externals during the linking run. 


NOTE 
The externals and globals processed by the linker 
are the symbols declared as EXTERNAL and as 
GLOBAL in MACRO8000 modules. Since the modules 
have already been assembled, the linker does not 
have any record of the other identifiers used in 
the MACRO8000 program. 


For some programs or modules targeted for an AmZ8001, the linker has 
another important function: to assign program segments to hardware 
segments. In order to explain this function we will have to explain 
the notion of a segmented address. 


The AmZ8001 processor generates two-component segmented addresses. The 
first component, a seven-bit segment number, is generated on lines 
SNo-SNg (see the AmZ8000 Family Data Book). The second component, 
a 16-bit offset, is generated on lines ADg-AD15- The AmZ8002 
processor, which MJlacks lJlines SNo-SN¢, generates one-component 
non-segmented addresses that are l6-bits long. 


The address space of the AmZ8002 is thus a single, 64K linear space. 
The AmZ8001 address space, on the other hand, consists of 2/’=128 
Separate 64K linear address spaces, which we will call hardware 
segments (to distinguish them from program segments). The linker 
directive SETLSEG can be used to assign program segments to different 
AmZ8001 hardware segments. In the AmZ8002, all program segments are 
put into the same 64K address’ space. Read chapter 3 for more 
information. 


In this manual, whenever there could be confusion between hardware 


segments and program segments, they will be explicitly distinguished. 
Usually, the meaning is clear from the context. 
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1-3. INVOKING THE LINKER 


The command to call the LINK8000 linker specifies the location of the 
linker directives and the other options for the linking run. The call 
is: 


LNKZ dirfile options overrides 
The call is entered with a carriage return (new line key). 
For interactive linking, the linker directives are supplied one by one 
at the console. For a linking test, where defaults are used on all 
options, the call is: 

LNKZ 
For an interactive linking run where other options on the product call 
are needed, the specification * indicates that linker directives will 
be entered from the console. For example: 


LNKZ * B 


calls for linking directives from the console, specifies the option B, 
requests defaults for the other options, and ignores overrides. 


For a file containing linker directives, the specification of dirfile 
Ls 


Field Meaning Default 

dev: Optionally specifies a Currently selected drive 
device name, such as A: 
or B: 


filename Specifies the name of the aaa 
directives file 


-ext Optionally specifies the ~DIR 
file type of the directive 
file 


For example: 
LNKZ DIR4 


calls for linking according to the directives in file DIR4.DIR, 
requests defaults for the options, and ignores overrides. 


NOTE 
Since LINK8000 has free format statements, a number 
of linker directives (separated by semicolons) can 
be entered on a single line. This technique is 
recommended for interactive input to the linker, 
since it saves time and keystrokes. 


The dirfile specification (or *) can be followed by at least one space. 


and then the selected options. The options listed in Table 1-1 are 
similar to the MACRO8000 options. Options can be specified in any order 
and are separated by commas or spaces. 


For example: 
LNKZ DIR5 L,B=XRPROC 


calls for linking according to the directives on file DIR5.DIR, 
requests a listing named DIR5.PRN, produces a file named XPROC. BIN that 
is suitable for downloading, and ignores overrides. 


The format of the hex file produced by the linker is described in 
Appendix B. The binary file formats for both the AmZ8001 and the 
AmZ8002 are described in Appendix C. 


The product call line can optionally include overrides for one or more 
symbolic constant values in the linker directives. The overrides follow 
all of the other options and are separated by commas. The overrides 
work in the same way as for MACRO8000 (see the MACRO8000 manual). 


NOTE 


When LNKZ is invoked with a directive file, 
the display of directives encountered is 
normally suppressed unless one of the L op- 
tions is used. The L option causes the di- 
rectives to be displayed on the named out- 
put device. 


TABLE 1-1. LINK8000 OPTIONS LIST 


Listing Send listing to dev:name.PRN 
on currently selected drive, 
with same name as dirfile 


Send listing to the file 
dev:name.ext as specified 


Send listing to console device 
(if printer is enabled with 
CONTROL P, listing also prints) 


Send listing to printer device 
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TABLE 1-1. LINK8000 OPTIONS LIST (Cont.) 


Object No object Create object file dev:name.ZRL 
(for file on same drive as dirfile, 
MODULE, with same name as dirfile 
LIBRARY, 
ROMLIB O=file Create object file dev:name-.ext 
run only) as specified. The file type 
| should not be $$$ 
Hex No hex file H Create hex file dev:name.HEX 
(for for PROM on same drive as dirfile, 
| AmZ8002 =| burning with same name as dirfile 
f PROGRAM 
4 only) 
H=file Create hex file dev:name-ext 


as specified 


Binary No binary B Create binary file dev:name.BIN 
(for file for on same drive as dirfile, 
PROGRAM down loading with same name as dirfile 


run only) 


fc B=file | Create binary file dev:name.ext 
vt as specified 
ROMLIB No ROMLIB as R Create ROMLIB dev:ROMLIB.ZRL 
(for linker output on same drive as dirfile 
PROGRAM from RETAIN 
run only)|or OMIT R=file Create ROMLIB file dev:name.-ext 


as specified. This file, which 
is called a ROM library index or 
ROMLIB, contains global symbol 
definition. A ROMLIB- might 
contain entry points for shared 
code (particularly in ROM), such 
as for a shared set of floating 
point routines which are always 
resident and at a fixed address. 
A ROMLIB can also be used to 
supply addresses of global 
symbols for symbolic debugging. 


NOTE 


When interactive input is specified (*) with 


options L, O, H, or B (without explicit 
filename), a default filename LINK is 
supplied in lieu of dirfile. 
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| CHAPTER 2 
GENERAL PURPOSE LINKER DIRECTIVES 


Since LINK8000 and MACRO8000 general purpose directives are similar in 
many ways, this chapter makes frequent reference to features of 
MACRO8000. Users should consult the MACRO8000 User’s Manual referred 
to in the preface for more information. 


The user should briefly check the information covered in this chapter 
and then study the functional linker directives described in Chapter 3. 
The sample PROGRAM run for the AmZ8002 (Chapter 4) and for the AmZ8001 
(Chapter 5), the MODULE run (Chapter 6), the LIBRARY run (Chapter 7), 
and the ROMLIB run (Chapter 8) should also be examined. 


2-1. STATEMENT FORM 


The statements in LINK8000 are linker directives, but the rules are the 
same as for MACRO8000. For example: 


PROGRAM START; 
FILE MOD1, MOD2; 
ABSOLUTE #4000 
END. 


is equivalent to: 


PROGRAM START; FILE MOD1, MOD2; ABSOLUTE #4000 END. 


2-2. SINGLE STATEMENT 


The single statement consists of a statement beginner followed by zero 
or more operands, as in MACRO8000. For example: 


SEARCH LIB1, LIB2; % statement beginner is SEARCH 
% operands are LIBI1 and LIB2 


NOTE 


For LINK8000 interactive input of directives, the 
semicolon at the end of a line can and should be 
omitted, since a carriage return (new line key) 
indicates the end of a statement. The semicolon 
must still be used between statements on the same 
line. 


For example: 


==> FILE MOD1, MOD2 
==> FILE MOD3; SEARCH LIB1, LIB2 


2-3. COMPOUND STATEMENT 


A compound statement consists of BEGIN, single statements, and END, as 
in MACRO8000. For example: 


BEGIN 
FILE MODI, MOD2; 
SEARCH LIBI, LIB2 
END; 


2-4. COMMENTS 


Comments can be embedded anywhere in the source text (except within 
literal strings) by enclosure between (* and *), as in MACRO8000. For 
example: | 


SEARCH LIB1(*I/O ROUTINES*), LIB2; 


A percent sign comment is terminated by end of line, as in MACRO8000. 
For example: 


SEARCH LIB1, LIB2; % LIB1 is I/O ROUTINES 


2-5. DELIMITERS 


Within statements, the standard delimiters are blanks, commas, and 
parentheses, as in MACRO8000. Blanks can be used freely in statements. 
Commas are used to separate operands. Parentheses are primarily used 
for lists. 


NOTE 


LINK8000 additionally has brackets [ and ] that are 
used in forming sets. 


The keywords BEGIN and END are special delimiters used in compound 
statements. The keywords THEN and ELSE are special delimiters used in 
IF directives. The keywords IN and DO are special delimiters used in 
FOR directives. 


2) 
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2-6. IDENTIFIERS 
The identifiers that can be used in LINK8000 directives are: 


Linker directives (predefined statement beginners) 
Macro names (user-defined statement beginners) 
File names (operands) 

Module names (operands) 

Segment names (operands) 

Symbolic constants (operands) 

Object variables (operands) 


The identifiers are similar to MACRO8000 identifiers and can be as long 
as 8U characters. The characters A through Z, U through 9, underiine, 
and @ can be used in an identifier, but an identifier cannot start with 
a digit or an underline. For example, valid symbols are: 


DEX 
FILE3 

@B14INC 
TEST FOR VALUE 


2-7. STATEMENT BEGINNERS 


The statement beginners are the identifiers that indicate the purpose 
of the statement. A statement beginner can be a linker directive or the 
name of a macro defined by the user. 


2-8. DIRECTIVE NAMES 


A directive is a special instruction to the linker. For instance, 
directives are used to specify input files and library names. For 
example: 


FILE MOD1, MOD2; % FILE directive is the statement beginner 


The directives are statement beginners, but some directives are con- 
sidered reserved words and some can be redefined. The directives CONST, 
VAR, MACRO, IF, and FOR are considered reserved words. The names of all 
the other directives can be redefined as macro names by the user. 


2-9. MACRO NAMES 


A macro is defined by the user with the MACRO directive (described 
later in this chapter). The macro name is an identifier. A macro must 
be defined before being referenced; that is, the macro definition must 
precede any references to the macro. For example: 


Z=3 


MACRO HL/ PARM1; % HL/ is defined as a macro 
BEGIN 


HL/ 5; # HL/7 macro name is the statement beginner 


2-10. OPERANDS 


In general, the operands in a statement always follow the statement be- 
ginner. For directives, the operands are values required for the 
directives. For macro references, the operands are the _ macro 
parameters. 


2-11. FILE NAMES 


The file names used as operands can be specified in the same way as 
file names in AMDOS commands. A complete file name has the general 
form: 


dev:name.type 


where dev is the drive designator such as A: or B:. The 
default is the same drive as for the directives file (for 
interactive input, the current drive) 


where name is the file name consisting of 1 to 8 characters. 
Just as for AMDOS file names, the name can be * or can 
include ? wild card characters. The * indicates any name of 
any length; the ? indicates any character in that position 


and where type is the file type (extension) consisting of 1 to 
3 characters. Just as for AMDOS file names, the type can be * 
or can include ? "wild card" characters. The * indicates any 
type; the ? indicates any character in that position. The 
default is .ZRL for the file type 


A complete file name, or any part of the full form, can be specified as 
an identifier or as a string enclosed in apostrophes. Any part that 
includes special characters (characters which cannot be used in an 
identifier) must be specified as a string. Therefore, any file name 
involving pattern matching with * or ? must be specified as a string. 


The drive and extension can be specified or allowed to default. The 
and . in the full form are effectively delimiters and can be used 
between the device, name, and extension. The following specifications 
are equivalent to using the full FILE A:PROG.ZRL; form: 


i 


FILE PROG; % using one identifier and defaults 


FILE ’PROG’; % using one string and defaults 
FILE A:PROG.ZRL; % using three identifiers 

FILE A : PROG . ZRL; % using three identifiers 

FILE “°A:PROG.ZRL’; % using one string 


FILE ‘’A:’ & “PROG.ZRL’; % using a concatenated string 


CONST DRIVE = A, 
NAME = PROG, 
TYPE = ZRL; 


FILE DRIVE:NAME.TYPE; % using three symbolic constants 


For more compact file name specifications, the user can take advantage 
of the AMDOS-type file specification. For instance: 


FILE ’*’; 


indicates that all files with file type .ZRL are to be used as 
relocatable input. The files named X.ZRL and Y.ZRL would both be used. 
As another example, the linker directive: 


FILE ‘’RF?.ZRL’; 


indicates that all files with RF as the first two letters, any 
character (or no character) for the next position, and file type .ZRL 
are to be used. If present on the diskette, the files RFA.ZRL and 
RF8.ZRL would both be used. See the FILE directive in chapter 3. 


2-12. NAMES OF MODULES AND SOFTWARE SEGMENT 


The module names used as operands in linker directives are the module 
names assigned during MACRO8000 assemblies. The linker supports the use 
of a single module name or a list of module names. The software segment 
names used in the directives are just the segment names assigned during 
MACRO8000 assemblies. 


The module names and segment names can be identifiers, strings, or (in 
certain cases, as noted below) as pattern strings containing the ? wild 
card character. Just as for file names, module names and segment names 
must be strings if the names include characters that cannot be used in 
identifiers. For example: 


COMBINE ‘CRT I0’.DATA; 


specifies module name “CRT IO’ and segment name DATA. 


2-13. CONSTANTS 


Numeric constants can be decimal, binary, octal, hexadecimal, variable 
base, or in K, just as for MACRO8000. For example: 


5 
11B. 
6420 
#6F 
4#123 
2K 


are all valid numeric constants. 


2-14. NUMERIC EXPRESSIONS 


A numeric expression can be evaluated at link time to produce a 32-bit 
Signed value, just as for MACRO8000. For example: 


5 

4K / 8 

ee ae ee | 

5 * (4 + 1) 


are all valid numeric expressions. 


2-15. LOGICAL EXPRESSIONS 


A logical expression can be written in the IF directive for evaluation 
at link time. The logical expressions are the same as for MACRO8000. 
For example: . 


NULL X 
URT OR SWITCH 
L123 LT 4 


are all valid logical expressions, as long as they result in a true or 
false value. 


2-16. STRINGS 


Strings can be used for file names, module names, or segment names in a 
number of LINK8000 directives. Strings are specified just as in 
MACRO8000. In all cases, a string or string expression can be used. For 
example: 
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“ABCDEF ’ 

“O00A0’ 

oe A ba ret 

“B:’ & ’ABCD’ & *.ZRL’ 


are all valid strings. 


2-17. LISTS 


A list is a composite object that represents a grouping of items, just 
as for MACRO8000. The primary uses of a list are in the FOR statement, 
and in the COMBINE directive for a list of module names. 


NOTE 
In LINK8000, the operator & is extended and can be 
used for lists as well as strings. 


The operator that can be used for building lists is: 


Operator Meaning Example 
& Concatenate A & (B, C, D) 


The operators that can be used for manipulating lists are: 


Operator Meaning Example 
ATOM ATOM Y is TRUE if Y is ATOM LIST 


neither a list nor a set 
(that is, atomic) and FALSE 
otherwise 


FIRST Take and use the first item FIRST (X, Y, Z) 
in a list; undefined if its 
argument is not a list 


REST Create a new list of all REST (X, Y, Z) 
items in the list except the 
first element; undefined if 
the argument is not a list 


For example, FIRST (X, Y, Z) has the value X, and REST (X, Y, Z) has 
the value (Y, Z). (When REST is applied to a single-element list, the 
result is NIL. For example, REST (A)=NIL.) For processing an item 
that might be a file name or a list of file names, the user might 
write: 


VAR X: OBJECT; 


IF ATOM PP 
THEN FILE PP % uses the single file 
ELSE FOR X IN PP 
DO FILE X; % uses each file in the list 
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Sublists are possible, where an item is itself a list. For example: 


Cay: %25. (C4, 92) 


2-18. SETS 
Like a list, a set is a composite object containing items. A set is 
used to specify a group to be processed by the linker. Certain linker 
directives accept a specification of a set of files, modules, segments, 
or globals. A set with one item has the form: 

fitem] 
A set with two or more items has the form: 


[item,item...] 


Each item in the set can be any valid operand, except another set or a 
list. For example, a set of module names might be: 


[CRT IN, CRT OUT, CRT STAT, PRINTER OUT, PRINTER STAT] 


The operators that can be applied to sets are the Pascal operators: 


Operator Meaning Example 
+ Set union (combination of — Sl + S2 


all elements) 


- Set disunion (removal of Sl - §2 
selected elements) 


* Set intersection (result Sl * §2 
containing only elements 
found in both sets) 


The empty set has the special value NIL. 


~N 


NOTE 


Sets, as well as lists, can be used in a FOR loop. 


2-19. SYMBOLIC CONSTANTS 


A symbolic constant is an identifier that represents a constant value 
during the linking process. Symbolic constants are declared by the 
CONST directive (described later in this chapter). The CONST 
declaration works just as in MACRO8000, and the same rules apply. For 
example: | 
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CONST DRIVE = B; 


FILE DRIVE:XR.ZRL; 


AvValue B:XR.ZRL 


2-20. OBJECT VARIABLES 


An object variable is an identifier that represents a variable value 
during the linking process. Object variables are declared with the VAR 
directive (described later in this chapter). The VAR declaration works 
just as in MACRO8000, and the same rules apply. For example: 


VAR LIB: OBJECT; % LIB is initially undefined 
IF SWITCH 
THEN LIB ::= LITH LIB is defined as LITH 


LIB is defined as LITH3 
uses either LITH or LITH3 


ELSE LIB LITH3; 


SEARCH LIB; 


Oe A 


NOTE 


For interactive input to the linker, the special 
value @INPUT is defined for object variables. 


The special value @INPUT tells the linker to accept a value supplied 
from the console during a linking run. For example: 


VAR ANSWER: OBJECT; 
PRIN ‘ENTER STACK SIZE: ’; 
ANSWER ::= @INPUT; 
ABSOLUTE (S$ + ANSWER); 


2-21. LOCATION COUNTER 


The special symbol $ represents the current value of the location 
counter. The location counter changes with the assignment of base 
addresses to the user segments. For example: 


CONST STACK SIZE = #100; 


ASSIGN STACK := ($ + STACK SIZE)*; 
7 assigns a value #100 greater than the 


location counter to identifier STACK 
STACK is assumed to be an unsatisfied 


Ol SV XX FY 


PRINT “LOCATION COUNTER IS 


external. 
NOW: °, S$; 
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2-22. GENERAL PURPOSE DIRECTIVES 


A number of linker directives are the same as for MACRO8000 or similar 
to MACRO8000. These directives can be used as needed for the linking 
process and placed anywhere within the linker directives. 


2-23. CONST DIRECTIVE 


The CONST directive declares a symbolic constant (described earlier). A 
symbolic constant is an identifier that represents a constant value. 
The CONST directive has the same form as in MACRO8000. For example: 


CONST ROM OFFSET #5000, 


CRTSET = [CRT_IN, CRT OUT, CRT STAT], 
PRNSET = [PRINTER OUT, PRINTER STAT], 
LOSET = CRTSET + PRNSET; 


2-24. VAR DIRECTIVE 


The VAR directive declares an object variable (described earlier). The 
VAR directive has the same form as in MACRO8000. For example: 


VAR NAME: OBJECT; % declares NAME as object variable 


NAME ::= XY3 _ & defines value of NAME 
FILE NAME; % identical to FILE XY: 


2-25. IF DIRECTIVE 


The IF directive can be used for conditional linking. In conditional 
linking, linking operations are performed or not performed depending on 
a particular condition. The IF directive has the same form as in 
MACRO8000. 


NOTE 
For LINK8000, the IF statement is always effective 
at the time when the linking directives are being 
processed. In this respect, the LINK8000 IF is 
like the MACRO8000 assembly time IF and not like 
the MACRO8000 run time IF. 
The test for conditional linking is a logical expression that can be: 
TRUE or FALSE 


An expression with the NULL operator and an object variable 


An arithmetic comparison 


-_ 


An: 


A string comparison 

A logical operation with NOT 

A logical comparison with AND or OR 
For example: 


IF SWITCH AND NOT NULL X 
THEN BEGIN 
SEARCH HRTLIB; 
SEARCH FOLLIB 
END 
ELSE SEARCH USERLIB4; 


2-26. FOR DIRECTIVE 


The FOR directive is used for repetitive linking, where linking 
directives are used repeatedly in a specific way. The FOR directive has 
the same form as for MACRO8000. For example: 


CONST SEGLIST = (DATAl, DATA2, DATA3); 
VAR X: OBJECT; 


FOR X IN SEGLIST DO 
BEGIN 
SEGMENT X; 
COMBINE .X 
END; 


NOTE 


EXIT can be used to terminate a FOR loop. EXIT must 
be used in the immediate context of the FOR loop. 
When EXIT is encountered, repetitive linking 
terminates and the linker moves on to the next 
Statement after the FOR statement. 


2-27. PAGE DIRECTIVE 


The PAGE directive sets the size of each listing page in the .PRN file 
and has the same form as in MACRO8000. For example: 


PAGE 48; 


9-28. EJECT DIRECTIVE 


The EJECT directive causes a page eject in the PRN file and has the 
same form as in MACRO8000. For example: 


EJECT; 


2-29. MACRO DIRECTIVE 


The MACRO directive declares a macro and takes the same form as in 
MACRO8000. In LINK8000, macros can be used for the expansion of linker 
directives. Each linker directive macro has the same general form as in 
~MACRO8000, and the macro parameters work in the same way. For example: 


MACRO LOGICALSEGMENT SEGNAME, MODULELIST; 
BEGIN 
SEGMENT SEGNAME; 
COMBINE MODULELIST.DATA, MODULELIST.CODE 
END; 


LOGICALSEGMENT SEG4, (MAB,MAD,MAF,MAH) ; 


NOTE 


EXIT can be used to terminate a macro. EXIT must be 
used in the immediate context of the macro. When 
EXIT is encountered, macro expansion terminates and 
the linker moves on to the next statement after the 
macro call. 


2-30. PRINT DIRECTIVE 


The PRINT directive is used to display one or more objects or operands 
at the console. The form is: . 


PRINT objectsequence; 


where objectsequence is a sequence of one or more operands or 
objects separated by commas. 


Any strings to be displayed at the console are enclosed in apostrophes 


in the PRINT directive but displayed at the console without 
apostrophes. For example: 
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==> X ::= 16 

==> PRINT X 
#00000010 

==> Y ::= “SIZE = ° 
==> PRINT Y 

SIZE = 

==> PRINT Y,X 

SIZE = #0000010 


Note that PRINT displays the objects and then terminates the line with 
a carriage return/line feed sequence. 


2-31. PRIN AND TERPRI DIRECTIVES 
PRIN has the same form as PRINT: 
PRIN objectsequence; 


but the display is not terminated with carriage return/line feed. The 
TERPRI directive has the form: 


TERPRI3 


The TERPRI directive terminates the line and is normally used after one 
or more PRIN directives: 


==> VAR Z: OBJECT 

==> FOR Z IN (THIS, IS, A, LIST) DO PRIN Z,’ ’;TERPRI 
THIS IS A LIST 

==> FOR Z IN (THIS, IS, A, LIST) DO PRINT Z 

THIS 

IS 


2-32. INCLUDE DIRECTIVE 


The INCLUDE directive specifies a file containing additional linker 
directives and arguments to be used in the linking process. The 
contents of the file are substituted for the directive in the linker 
input. This directive can be nested to three levels. The INCLUDE 
directive has the same form as in MACRO8000. For example: 


INCLUDE ‘10 SET’; 


oo 


CHAPTER 3 
FUNCTIONAL LINKER DIRECTIVES 


The user supplies linker directives to describe the linking operation. 
The general purpose directives (described in chapter 2) can be 
interspersed with the functional linker. directives described in this 
chapter. The linking operation itself involves directives to: 


e Specify the basic type of link to produce a program, module, 
library or ROM library. A PROGRAM, MODULE, LIBRARY, or ROMLIB must 
be the first directive. 


e Specify the relocatable input to be used for the linking operation. 
The relocatable input consists of files containing relocatable 
code, as well as any libraries needed for the linking operation. 
The linker must have access to the modules and segments before it 
can manipulate them. 


e Specify and control the actual linking process. The user can set 
absolute addresses, define new relocatable software segments, 
combine software segments. in an arbitrary way, assign software 
segments to AmZ8001 hardware segments, and assign absolute entry 
points to specific unsatisfied externals. 


e Specify any additional output from the linker. For an absolute 
program, the user can generate an additional file (ROM library) 
containing entry points to absolute code in PROM. At any time 
during the linking run, the user can generate a variety of linker 
mapSe 


In the linker directives, the specifications of link type, relocatable 
input, linking control, and additional linker output should essentially 
be in the order shown. The one exception is that maps can be requested 
at any time. 


Note that an AmZ8002 user does not necessarily need LINK8000 to produce 
absolute code suitable for PROM burning or downloading. A_ single 
monolithic program can simply be assembled through MACRO8000 to produce 
a hex file for PROM burning (H option on the MACZ call) or an AMC 
binary file for downloading (B option on the MACZ product call). In 
this case, PROGRAM is used as the first directive in the assembly 
program and not run through the linker. 


A user targeting for the AmZ8001 must always use LINK8000 to produce 
absolute code suitable for PROM burning or down-loading. Only binary 
files can be produced; hex is not available for the AmZ8001. 


If the user has a program structured into a number of interrelated 
parts, MACRO8000 and LINK8000 are used together to prepare the program. 


In this case, MODULE is used as the first directive in each part of the 
program, and the assembler produces files containing relocatable code 
(O option on the MACZ product call). 


3-1. TYPE OF LINK 


The choice of the basic type of link is required as the first linker 
directive. In all cases, the user chooses one directive specifying the 
type of link and supplies it as the first directive. Therefore, the 
linker directives have the framework: . 


Program Module Library ROM library 
creation creation creation creation 
PROGRAM MODULE LIBRARY ROMLIB 
through through through through 
END. END. END. END. 


The special terminator END. is used, just as in MACRO8000, to mark the 
end of the linking run. 


3-2. PROGRAM 


The PROGRAM directive specifies the creation of an absolute program 
_ suitable for downloading. PROGRAM also specifies the main entry point, 
which must be a global label defined in one of the relocatable input 
modules. The PROGRAM directive has the form: 


PROGRAM lab; 
where PR is abbreviation of PROGRAM 


and where lab is a label that specifies the main entry point 
of the program. The label can also be specified as a string or 
string expression 


Appearance of a PROGRAM directive indicates that the user is linking 
relocatable code in order to produce absolute code. 


The relocatable files produced by MACRO8000 and/or LINK8000 are used as 
input to LINK8000. From those input files targeted for the AmZ8002, 
the linker can produce either a hex (option H) or a binary (option B) 
output file. This output file can be used either for PROM burning or 
down-loading. Input files targeted for the AmZ8001 can produce only a 
binary output file. See figure 3-1. For a description of the hex and 
binary file formats, refer to Appendices B and C. 
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PROGRAM mode - 
directives optional 
(required) binary file 


relocatable optional 
input files hex file 
(required) (AmZ8002 only) 


optional 
optional | ROM library 
libraries to | creation 
be searched 


Figure 3-1. PROGRAM Creation Run 


The user has separate assemblies of modular program parts. The program 
parts reference each other in user-defined ways through the use of 
global and external declarations in separate modules. The result of 
the linking operation is simply to combine the separate modules and 
produce a coherent program. 


See Chapter 4 and 5 for examples of program creation runs for the 
AmZ8002 and AmZ8001 processors. 


3-3. MODULE 


The MODULE directive specifies the creation of a combined module that 
is still relocatable. The MODULE directive has the form: 


MODULE modname;3 
where MOD is the abbreviation of MODULE 


and where modname is an identifier, a string, or a string 
expression to be used as the name of the combined module 


The combined relocatable can be an intermediate step in the creation of 
an absolute program. In this case, the module can be used for an 
incremental linking operation. Incremental linking involves’ the 
condensation of a set of input modules into a single relocatable module 
that can be later combined with other single or combined relocatable 
modules. Effectively, incremental linking represents a succession of 
intermediate steps in the creation of a coherent program. In a final 
PROGRAM creation run, the program would be set up for downloading to an 
AmZ8002 processor. See figure 3-2. 


MODULE mode 
directives 
(required) 


~~ combined 
relocatable relocatable 
input files _ module file 


(required) 
optional 


libraries to 
be searched 


Figure 3-2. MODULE Creation Run 


The MODULE directive can be used in any case where it is desired to 
defer address resolution until a future time, for example, the case 
where a user operating system is handling the loading. 


See Chapter 6 for an example of a module creation run. 


3-4. LIBRARY 
The LIBRARY directive specifies the creation of a library of 
relocatable routines that can be accessed in subsequent linking 
operations. The LIBRARY directive has the form: 
LIBRARY libname; 
where LIB is the abbreviation of LIBRARY 


and where libname is an identifier, a string, or a string 
expression to be used as the library name 


A library can be constructed from an arbitrary collection of modules or 
from subsets of other library files. The library as created contains: 


A directory of globals and externals associated with the routines 
in the library 


The library routines in relocatable form 
The user can choose to create relocatable libraries and access them 
during creation of a particular program. In this case, the library can 


be used at different times for the creation of any number of particular 
programs. See figure 3-3. 
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LIBRARY mode 
directives 
(required) 


relocatable ~ relocatable 
input files | library file 
(required) 


Figure 3-3. LIBRARY Creation Run 


See Chapter 7 for an example of library creation run. 


3-5. ROMLIB 


The ROMLIB directive specifies the creation of a ROM library index from 
subsets of other ROM libraries or from a set of explicitly-defined 
entry points assigned with the ASSIGN directive. The ROMLIB directive 
has the form: 


ROMLIB rlibname3 
where RLIB is the abbreviation of ROMLIB 


and where rlibname is an identifier, a string, or a string 
expression to be used as the ROM library name 


The ROMLIB directive is not normally used for the initial ROM library 
creation (although it can be done using the ASSIGN directive). Note 
that a ROM library index can be created with the R option as additional 
linker output during a PROGRAM run. See figure 3-4. The library index 
produced can be used to access a ROM resident library or used as input 
for symbolic debugging. 


ROMLIB mode 
directives 
(required) 


relocatable 

ROM library ROM library 
files (from | file 
PROGRAM runs) _ 


Figure 3-4. ROMLIB Creation Run 


See Chapter 8 for an example of ROM library creation run. 


3-6. HEADER 


The HEADER directive supplies one or more header lines at the beginning 


of the relocatable output file (file type .ZRL by default) produced as 
the main linker output of a MODULE, LIBRARY, or. ROMLIB creation run. 
The HEADER directive has the form: 


HEADER strings; 
where HDR is the abbreviation of HEADER 
where strings is a sequence of strings separated by commas 


and where each string is a string or string expression that 
produces one identification line in the .ZRL file 


The HEADER directive is highly recommended for supplying any additional 
information the user wishes at the beginning of the .ZRL file. When a 
-ZRL file is listed at the console with an AMDOS TYPE or DISPL command, 
the header lines are displayed as part of the first block of 
information in the .ZRL file. The other information in the relocatable 
file is not displayed, unless the user dumps the entire file with the 
AMDOS DUMP command. 


For example: 


HEADER ’I/O routines’; 


3-7. RELOCATABLE INPUT 


A number of linker directives specify the relocatable input to be used 
for the linking operation. The directives that can be used are: 


Program Module Library ROM library 
creation creation creation creation 
FILE FILE FILE FILE 

SEARCH SEARCH 

ATTACH ATTACH 

DETACH DETACH 


These directives are described in the following paragraphs. 
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3-8. FILE 


One or more FILE directives specify the .ZRL files that are to be used 
as relocatable input to the linking operation. The .ZRL files can be 
assembled MACRO8000 modules, combined modules, libraries, or ROM 
libraries. The FILE directive has the form: 


FILE filesequence; 
where FL is the abbreviation of FILE 


where filsequence is a list of one of more file specifications 
separated by commas. 


and where each file specification in the filesequence has one 
of the forms: 


name A relocatable module file. The name can be 
in the form dev:name.ext. The default 
drive is the current drive, and_ the 
default file type is .ZRL 


pattern | A file name pattern of the AMDOS type, 
where the name can contain * as a general 
specification for any file name or file 
type, and where ? can be used as a wild 
card for any individual character in the 
file name or file type. 


lib A relocatable library or ROM library file. 
The name can be in the form dev:name.ext. 
The default drive is the current drive, 
and the default file type is .ZRL. 


lib * set A relocatable library file name followed 
by * and set of module names. The entry 
points to be used are restricted to the 
ones that are both in the library and in 
the set of modules specified 


lib - set A relocatable library file name followed 
by - and a set of module names. The entry 
points to be used are the ones in the 
library, except that entry points in the 
specified set of modules are omitted 


The set of module names can be any set or parenthesized set expression 
(see SETS, chapter 2). In this context, a module name in a non-empty 
set can be an identifier, string, or a pattern string containing the ? 
wild card character. 


A standard example of the FILE directive for relocatable input is: 


FILE X,Y3 % specifies relocatable files X.ZRL and Y.ZRL 


Some examples using patterns for the file names are: 


FILE ’*.ZRL’; % might specify files A.ZRL, B.ZRL, and F.ZRL 
; % that exist on the current drive 


CONST ALL = ’%’; 
FILE ALL; % same as FILE ’*.ZRL’ 


When the FILE directive is used for a library, all the routines in the 
library are used as relocatable input to the linker. For a library 
search, see the SEARCH directive. An example of the FILE directive for 
a library might be: 


FILE DEF; % specifies library file DEF.ZRL 


An additional feature of the FILE directive for a library is the 
ability to restrict entry points to be used or to omit selected entry 
points. The special forms of the lib specification are: 

FILE DEF * [DEF3]; specifies library DEF3, restricting the 
entry points to the ones also contained in 
the module DEF3.ZRL 


Ol NK 


specifies library DEF.ZRL but omits the 
entry points in modules designated by the 
pattern ‘’DEF?’. 


FILE DEF - [’DEF?’]; 


Oe 


3-3. SEARCH 
The SEARCH directive accesses the library specified by providing access 
to the entry points in the library routines. The SEARCH directive 


initiates the process of satisfying any outstanding externals from the 
modules in the library. The SEARCH directive has the form: 


SEARCH libsequence; 
where SR is the abbreviation of SEARCH 


and where libsequence is a sequence of one or more relocatable 
library and/or ROM library files separated by commas. The 
library name has the form dev:name:ext. The defaults are 
current drive and file type .ZRL. 


The SEARCH directive for a library simply uses the library directory to 
satisfy externals. Note that the SEARCH directive is equivalent to an 
ATTACH immediately followed by a DETACH directive. Therefore, the 
library is accessed and then released. 


For a library, a SEARCH is different from a FILE. Using the FILE 
directive for a library moves in all of the library routines as 


relocatable input; using the SEARCH directive moves in only those 


routines required to satisfy outstanding externals. 
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For example: 
SEARCH XREF.ZRL; 


When two or more files are specified in on e SEARCH directive (eeg., 
SEARCH LIBI1,LIB2), any new externals introduced by a module in one 
library file can be satisfied by entry points in modules in the other 
library. In other words, all libraries in a sequence specified in a 
single SEARCH directive are ATTACHed before the corresponding DETACH. 


3-10. ATTACH 


The ATTACH directive accesses the library specified and leaves the 
library attached until a subsequent DETACH directive is encountered. 
The ATTACH directive has the form: 
ATTACH libsequence; 
where AT is the abbreviation of of ATTACH 
and where libsequence is a sequence of one or more relocatable 
libraries and/or ROM libraries separated by commas. The 
library name has the form dev:name.ext. The defaults are the 
current drive and file type .ZRL 


For example: 


ATTACH XREF.ZRL; 


3-11. DETACH 
The DETACH directive detaches the specified library. The DETACH 
directive is only used for a library accessed with ATTACH. The DETACH 
directive has the form: 
DETACH libsequence; 
where DT is the abbreviation of DETACH 
and where libsequence is a sequence of one or more relocatable 
libraries and/or ROM libraries separated by commas. The 


library name has the form dev:name.ext. The defaults are the 
current drive and file type .ZRL 


For example: 


DETACH XREF.ZRL; 
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DETACH removes (from the linker symbol table) all global and external 
labels and module names associated with the specified files. The 
reclaimed symbol table space may then be used in subsequent SEARCHs and 
ATTACHs. | , 


3-12. LINKING CONTROL 


After the type of link has been chosen and the relocatable input has 
been specified, the user can specify the linking operation itself in 
detail with a set of linking control directives. The number of control 
directives that can be used depends on the type of link chosen and 
whether the target processor is an AmZ8001 or AmZ8002. 


The directives that can be used are: 


PROGRAM PROGRAM 2 

link link MODULE LIBRARY ROMLIB 
(AmZ8001 ) (AmZ8002 ) link link link 
OFFSET ABSOLUTE SEGMENT #£RETAIN RETAIN 
SEGMENT ASSIGN COMBINE OMIT OMIT 
SETLSEG COMBINE RETAIN MAP MAP 
ASSIGN XSPACE OMIT 
COMBINE RETAIN MAP 
XSPACE OMIT 
RETAIN MAP 
OMIT 7 
MAP 


These directives are described in the following paragraphs. 


3-13. ABSOLUTE 


The ABSOLUTE directive can be used to specify an absolute destination 
address. This directive may be used only during a PROGRAM link that is 
targeted for an AmZ8002 processor. (For AmZ8001 links, the equivalent 
directive is OFFSET.) This directive has the following form: 


ABSOLUTE exp; 
where ABS is the abbreviation of ABSOLUTE 


and where exp is a numeric expression (usually hexadecimal ) 
specifying a memory address 


In program creation runs, the user needs to assign a starting location 
for the linked code. The user can also use ABSOLUTE directives to 
specify a number of destination addresses. For example, the user might 
assign absolute addresses to all globals in the program. | 


ae 


ABSOLUTE directives may also be intermixed with COMBINE directives to 
define the placement of all program code and data by assigning a 
destination address to each segment in the relocatable input. 


For example: 


ABSOLUTE #4200; 


COMBINE .CODE; % all code segments 
ABSOLUTE #5000; 
COMBINE .DATA; % all data segments 


The ABSOLUTE/COMBINE combination of directives in a program run 
corresponds to the SEGMENT/COMBINE directives in a module creation run. 


3-14. OFFSET 


This directive is the AmZ8001 equivalent to the ABSOLUTE directive. 
OFFSET is used to specify an 16-bit address offset in the current 
hardware segment. (See section 3-16 SETLSEG for a discussion of the 
current hardware segment.) 


In one special case OFFSET can be used to specify a hardware segment 
number as well as the offset. If OFFSET is used to specify an entry 
point of an attached ROMLIB, then the hardware segment number of the 
entry point address is assigned to the current output segment via an 
implicit invocation of SETLSEG. (The current hardware segment number 
counter is unaffected.) 


This directive may be used only during a PROGRAM link that is targeted 
for an AmZ8001 processor. It has the following form: 


OFFSET exp; 
where OFF is the abbreviation for OFFSET 
and where exp is an expression specifying a 16-bit offset into 
the current hardware segment or an entry point in an attached 


ROMLIB. 


For example, to specify an offset value of 1000 hex in the current 
hardware segment, the following linker directive would be used: 


OFFSET #1000; 


3-15. SEGMENT 


The SEGMENT directive can be used in PROGRAM links for the AmZ8001 or 
in MODULE links for both processors. In both links, the directive 
defines the name of an output software segment for incremental linking. 
The SEGMENT directive has the following form: 


SEGMENT segname; 

SEGMENT [attr], segname; 

SEGMENT @PRIOR; 
where SEG is the abbreviation of SEGMENT 
whene segname is the segment name 


where attr is an optional segment attribute: @COM common 
common (MODULE links only) 


and where @PRIOR indicates a reset to the segment previously 
defined | 


The segment name can either be an identifier or a string. The common 
attribute (@COM) will force the assignment of segments (with the same 
name) in different modules to a common memory space. Common segments 
in different modules should have the same size. A common segment is 
analogous to a Fortran common block. 


The set of input segments from the input modules have no necessary _ 


relationship with the set of output segments defined by the SEGMENT 
directive. For example, a set of input segments with the common 
attribute may be combined into a single output segment: 


SEGMENT COMDATA; 
COMBINE .COMBLOCK; 


The special indicator @PRIOR is used to reset to the previously defined 
(that is, prior) segment. In this case, the segment offset is set to 
the value last assigned. For example: 


SEGMENT @PRIOR; 


If no prior segment exists, SEGMENT @PRIOR generates an informative 
error and the current segment is used. 


3-16. SETLSEG 


This directive allows for explicit assignment of hardware segment 
numbers to the software segment names defined in the SEGMENT directive. 
SETLSEG can be used only in PROGRAM links for the AmZ800l1. If a 
SETLSEG directive is not given, the linker will assign consecutive 
hardware segment numbers by default. The linker maintains an internal 
hardware segment number counter in order to implement this directive. 
The directive has the form: 


—_ 


fi 
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SETLSEG ; 
or 
SETLSEG assignment sequence; 


where assignment sequence is a series of expressions separated 
by commas, each with the format 


segment name := exp 
or 
segment name 


where segment name is a software segment name and where exp is 
an arithmetic expressions for the hardware segment number with 
value 0-127. 


The SETLSEG directive with no arguments simply assigns segment numbers 
to the segment names in alphabetical order, beginning with the last 


assigned number (initially zero). 


The assignment expression segment name := exp sets the internal segment 
Number counter to the value exp, then assigns that value to the segment 
named segment name. The assignment expression segment_name assigns the 
current value of the segment number counter to segment name. After 
each assignment expressions, the linker increments the segment number 
counter. Default segment number assignments begin with the most recent 
segment counter value. 


For example: 
SETLSEG IOTASK := 1,DATABASETASK,SPACEMGRTASK ; 


assigns the software segment name IOTASK to hardware segment number 1, 
DATABASETASK to 2, and SPACEMGRTSK to 3. Subsequent SETLSEG directives 
will assign hardware segment numbers from 4 up, unless reset higher by 
an explicit assignments. 


Hardware segment number assignments must be strictly ascending. 


3-17. COMBINE 


The COMBINE directive specifies the combination of relocatable input 
segments (either from a MACRO8000 assembly or a previous linker run) to 
absolute addresses in the linker output. For program creation, COMBINE 
directs the assignment of modules and/or segments to absolute addresses 
(ABSOLUTE directive). For module creation, COMBINE directs’ the 
assignment of segments to a named output segment (SEGMENT directive). 
The COMBINE directive has the form: 


COMBINE; 


COMBINE BY MODULE; 


COMBINE BY SEGMENT; 


COMBINE segsequence; 


where CMB is the abbreviation of COMBINE 


and where segsequence is an optional sequence of one or more 


segment sepcifications separated by commas. Each’ segment 


specification can take one of the forms: 


mod 


seg 


mod.seg 


When COMBINE is used with no 


specifies a module name or list of module 
names enclosed in parentheses. In this 
form, each module name must be an 
identifier or string. 


specifies .« followed by the segment name. 
In this form, the segment name must be an 
identifier or string. 


specifies a module name, or list of module 
names enclosed in parentheses, followed by 
- and the segment name. In this form, each 
module name can be an identifier, a 
string, or a pattern string containing the 
? wild card character. 


operands, COMBINE means COMBINE BY MODULE 


and specifies the grouping by module of the sequence of input segments 


in the module. 
The basic scheme for COMBINE 


Relocatable input 


Module 
Module 


Module 
Module 
Module 


The basic scheme for COMBINE 


Relocatable input 


X Segment CODE --- 
X Segment DATA --~- 
Module Y Segment CODE --- 
Y Segment DATA -~- 
Z Segment CODE --- 
Z Segment DATA --- 


with no operands or COMBINE BY MODULE is: 
COMBINE or COMBINE BY MODULE 


----- > X.CODE 
----- > X.DATA 
----- > Y.CODE 
---—- > Y.DATA 
----- > Z.CODE 
----~> Z.DATA 


BY SEGMENT is: 


COMBINE BY SEGMENT 


Module X Segment CODE -------~ > XeCODE 
Module X Segment DATA _ _—--7 Y-CODE 
Module Y Segment CODE -"“\__y Z.CODE 
Module Y Segment DATA _|_~-~~S X.DATA 
Module Z Segment CODE ~ = ~~) Y.DATA 
Module Z Segment DATA -------- > ZeDATA 


When the COMBINE directive 


specifies a segsequence, the user is 


combining segments in an arbitrary way. For example: 


COMBINE .DATA; 4 combines all segments with the name DATA 


COMBINE SYMBOL TABLE.DATA, HASH TABLE.DATA; 
% combines segments with the names sepcified 


COMBINE (SYMBOL TABLE, HASH TABLE) .DATA; 
% same as the previous example 


CONST PARSER = (SCAN, NEXT CHAR, FIND, ENTER, PURGE); 


A DaAYNAETD NNNHT OF aca + ] 
A, LARSER.CODE; «2 uses the symbclic constant 


% PARSER to specify the list of module names 


If COMBINE has been used to combine some but not all segments, COMBINE 
with no operands can be used to combine all remaining unassigned 
segments. The user should request one or more link maps after every 
COMBINE in order to manage this process effectively. If any input 
segments remain unassigned at the end of the directive sequence (at 
END.), an implicit COMBINE will be invoked. 


3-18. XSPACE 


The status lines of the AmZ8000 can be used to extend the address 
space. For example, the status lines distinguish a data access from an 
instruction access, thus allowing instructions and data to be stored in 
different address spaces, if the memory hardware can decode the status 
signals. 


LINK8000 supports this extended address space concept through the 
XSPACE directive. An XSPACE directive can appear only once in such 
links. All program segments COMBINEd after the XSPACE directive are 
assigned to extended space. For example: 


COMBINE  .CODE; 
XSPACE; 
COMBINE  .DATA; 


assigns all .CODE segments to regular address space and all .DATA 
segments to extended space. 


XSPACE can be used with both AmZ8002 and AmZ8001 code. The only output 
file formed available is AMC binary format (option B). The directive 
causes the location counter to be reset to zero. For the AmZ8001, any 
previously unassigned output program segments are assigned hardware 
segment numbers (via an implicit call to the SETLSEG directive). 


The output file has several distinctive record types if XSPACE is used 
in the link. These additional types hold the extended space values; 
they are documented in Appendix C. Users must write software to read 


the binary file and select the extended space record types. Users must 
also write software to load the extended space information into the 
correct memory locations, a procedure that will depend on how the user 
has decoded the status lines. Contact your AMD Field Application 
Engineer for additional information and support. 


3-19. ASSIGN 


The ASSIGN directive causes the assignment of absolute addresses to 
identifiers. The ASSIGN directive has the form: 


ASSIGN assignmentsequence; 


and where assignmentsequence is a list of assignments 
separated by commas. Each assignment takes the form: 


lab := abs specifies a label that is set to the 
absolute address constant specified. The 
label cannot be a symbolic constant or 
object variable. The absolute address 
constant is either a single arithmetic 
value (AmZ8002) followed by “*, or a pair 
of values followed by “*, representing a 
segment number and an offset (AmZ8001). 


Constant is either a single arithmetic value (AmZ8002) or a pair of 
values, representing a segment number and an offset (AmZ8001). 


For example (AmZ8002): 


CONST STACK SIZE = #500; 

ASSIGN CRT STAT := #FF20*, 
CRT IN :=  #FF46%, 
CRT OUT := #FF80*, 


STACK := ($ + STACK SIZE)*; 
(AmZ8001): 
ASSIGN LAST ROM LOC := (3,#2000)*; 


For program creation, ASSIGN can be used to assign addresses for any 
unsatisfied externals. For a ROM library creation, ASSIGN causes the 
creation of global entry points with absolute addresses. 


In the program mode, the ASSIGN directive may also be used to assign 
(previously entered) globals to unsatisfied externals. For example, if 
DISK READ TEMP and DISK _ READ_ ) DIAG are entry poture: of a (previously 
entered) module, then 


: Re. ; ee 


pe 

ff 

a 
fate 
fi 
‘ey 
a, 

‘e 


IF DIAG THEN 
ASSIGN DISK READ 


DISK READ DIAG 


ELSE 


ASSIGN DISK READ := DISK READ DIAG 


will equate DISK READ to one of two entry points depending on the value 
of DIAG. 


3-20. RETAIN AND OMIT 


The KETALN directive is used to retain a record of ali oc some givobais 
in the program. The RETAIN directive has the form: 


RETAIN globalsequence; 
where RET is the abbreviation of RETAIN 


and where globalsequence is an optional sequence of globals 
separated by commas 


The OMIT directive has the form: 
OMIT globalsequence; 


where globalsequence is a sequence of globals separated by 
commas 


A global may be specified as an identifier, a string, or a pattern 
string containing the ? wild card character. 


The RETAIN directive retains the selected globals and omits the rest. 
The OMIT directive is used to omit selected globals but retain the 
rest. RETAIN and OMIT are opposite in meaning, and the user chooses the 
more convenient directive to use. 


For a program run with the R option, RETAIN or OMIT causes creation of 
a ROM library with a selected subset of (assigned) global entry points. 
The ROM library is a directory of entry points to the absolute code 
produced in the program run. Unlike a library, the ROM library contains 
only the directory and not the library routines themselves. The library 
entry points themselves are the main output of the link and are in 
absolute form. 


For a module run, RETAIN or OMIT affects the main linker output and 
selects a subset of entry points in the relocatable output. The entry 
points that remain, or are not omitted, can be used in a subsequent 
linking operation. For incremental linking, the entry points that were 
excluded are effectively hidden and are not available in any subsequent 
link. This technique can be used to protect the integrity of selected 
parts of the program. It can also be used to reduce the size of the 
symbol table required for linking very large, modular programs. 
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For a library run, RETAIN or OMIT affects the main output by 
restricting the set of globals that can be used to satisfy externals. 


For a ROM library run, RETAIN or OMIT affects only the directory and 
Specifies a subset of the previously defined entry points for the ROM 
libraries. 


3-21. MAP 


This directive produces a sorted list of globals, showing assigned 
addresses, segment mames, any unresolved externals, aand_ other 
Significant information. For the AmZ8001, assigned segment numbers are 
displayed as a pair of hex digits (if the segment number has been 
assigned at the time the MAP directive was executed). The directive 
has the following form: 


MAP; 
MAP BY option; 
the map options are: 

LABEL (same as MAP;) shows symbols, addresses, module 
names, and segment names, in the same order in 
which the relocatable files were accessed. For 
unassigned symbols, the address is an offset 
marked with * : 

MODULE shows module names, mod.seg, sizes, and 
assigned addresses, as well as unit sizes, ina 


list sorted by module name 


SEGMENT shows segments names, mod.seg, sizes, and 


assigned addresses, as well as unit sizes, ina. 


list sorted by segment name 


ADDRESS shows symbols and addresses in a list sorted by 
address. Because of space constraints, this map 
destroys some of the information in the MAP BY 
LABEL display. Therefore, this map should be 
the last map requested. (For a large number of 
entry points, there may be a e noticeable 
delay.) 


LIBRARY shows library entry points 
LIB MOD shows library modules (LIBRARY run only) 
OUT SEG shows output segments (MODULE run only) 


EXTERNAL shows symbols currently unassigned 


_ 
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CHAPTER 4 
A SAMPLE PROGRAM RUN (AmZ8002) 


This chapter contains a sample PROGRAM run for the AmZ8002 processor. 
Separate parts are assembled as modules and then linked together to 
produce absolute output. The absolute output is a binary file which is 
then downloaded to the AmZ8002 evaluation board and executed. 
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CHAPTER 5 
A SAMPLE PROGRAM RUN (AmZ8001) 


This chapter contains a sample AmZ8001 PROGRAM run. A Modules 
containing several software segments are linked to produce an output 
file. Each named software segment is assigned to a separate hardware 


segment. 

MACRO8O000: Version 2.0 9/19/80 

MACZ B:BUBEXEC] S O L=B:BUBEXEC1.PRN 
{ BUBEXEC1 

ooco 

0000 MODULE ‘’BUBEXEC1’; 

0000 

0000 (* AMZ8001 VERSION *) 

0000 

0000 | GLOBAL START; 

0000 

0000 EXTERNAL PROVPT ; 

lelere EXTERNAL READ; 

0000 EXTERNAL SORT; 

goo0 EXTERNAL WRITE; 

0000 EXTERNAL EXIT; 

0000 

0000 SEGVENT ‘CODE’; 

0000 START: 

0000 5FO0SO0002 0000 CALL PROVPT ; 

0006  $5F00S0003 0000 CALL READ; | 
; o0o00c | (* R3 CHAR COUNT FROM READ *) 
é 000C oBo3 o001 IF R3 LE 1 THEN 
X 0010 EAQ3 5E08S0007 JP START; 

0014 9000 

0018 5F00S0004 O0000 CALL SORT ; 

OOlE  #5FOOSO005 O0000 CALL WRITE; 

0024  #5F00S0006 0000 CALL EXIT; 

002A 

002A END. 


MACRO8 000: 
BUBPRPT 1 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 140450003 
0006 1406S0005 
o00C 610850005 
0012 

0012 BA6l1 0840 
0016 : 
0016 610850005 
001C  6F08s0002 
0022 5FO0S0004 
0028 9EF08 

002A 

002A 00 

002B 

002B 

002B 2B45 4E54 
0031 2043 4841 
0037 4354 4552 
003D 544F 2042 
0043 534F 5254 
0049 2C20 5448 
OO4F 2052 4554 
0055 420 

0057 

0057 
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0000 
002C 
OO02A 


002A 
0000 
Q000 


4552 
9241 
2320 
4520 
4544 
454E 
2552 


PROVPT : 


MESLEN: 


MESSAGE : 


9/19/80 


MODULE ‘“BUBPRPT1’; 


(* AMZ8001 VERSION *) 
GLOBAL PROT; 


EXTERNAL BUFLEN, BUFFER; are 
EXTERNAL WRITE; 


SEGVENT 

5 
LDL RR4} COB eee 
LDL a “VESSACE. + 1; 


LD 8, MESLEN; 

(* parr a i INTO BUFFER *) 
LDIRB RR4*, RR6*, RB; 

(* SET BUFFER LENGTH x) 

LD R8, MESLEN; 

LD BUFLEN, R8; 

WRITE; 


BYTE: 0; 


“ENTER CHARACTERS TO BE 
“SORTED, THEN RETURN “°;3 


END. 


| MACRO8 000: Version 2.0 9/19/80 
{ MACZ B:BUBSORT1 S O L=B:BUBSORT1.PRN 
\ : BUBSORT 1 
0000 
0000 MODULE ‘’BUBSORT1’; 
oooo | 
0000 (* AMZ8001 VERSION *) 
0000 
0000 GLOBAL SORT; 
oo00 
0000 EXTERNAL BUFLEN, BUFFER; 
NNAN 
0000 CONST LAST - RR2, 
0000 THIS - RR4, 
: 0000 NEXT - RR6, 
1 0000 LAST _CH = RH1, 
| 0000 THIS CH = RL1, 
oo00 COUNT - RB, 
ooo00 SWAPS = RI; 
ooo00 
0000 SEGVENT ‘CODE’; 
oooo0 SORT: 
0000 (* INITIALIZE FOR SORT *) 
0000 2109 oO000 LD. SWAPS, 0; 
0004 (* INITIALIZE POINTERS *) 
0004 140450003 ooO00 LDL THIS, “BUFFER; 
OO0A 9446 LDL NEXT, THIS; 
000C A970 INC R7, 1; 
O00F (* ADJUST WORKING COWNT *) 
OO0E 610850002 0000 LD COUNT, BUFLEN; 
0014 #AB8D DEC COUNT, 1; 
0016 | (* CY LATER USED FOR OV *) 
0016 8D8 3 RESFLG CY; 
0018 LOOK: 
0018 BA66 0848 CPSIRB THIS*, NEXT*, COUNT, LGT; 
: oo1Cc IF OV (* AT END OF STRING *) THEN 
t 001C £COl 8D81l SETFLG CY; 
0020 IF ZR (* SWAP NEEDED *) THEN 
0020 EEO7 BEGIN 
0022 (* GET POINTER TO LAST *) 
0022 9442 LDL LAST, THIS; 
0024 AB30 DEC R3, 13. 
0026 (* SWAP LAST AND THIS *) 
0026 2021 LDB LAST CH, LAST’; 
0028 2049 LDB THIS CH, THIS’; 
002A 2E29 LDB LAST*, THIS CH; 
002C 2E41 LDB THIS*, LAST CH; 
O02E (* INCREMENT SWAP COUNTER *) 
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| ee 
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BUBSORT1 | i 

O02E INC SWAPS, 1 

002E A990 END; 

0030 IF NC (* NOT AT END OF LINE *) THEN 

0030 £701 E8F2 IR LOOK; 

0034 8599 IF SWAPS NE O (* CHANGES MADE *) THEN 

0036 E601 E8E3 IR SORT ; 

003A 9E08 RET; 

003C 

003C END. 
ee 
ween 
& 


2st, 


f 
Ke 
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0052 
0052 
0000 
O000 
QOOO0A 
QO0A 
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MTRDATAL 


BUFLEN: 


BUFFER: 


9/19/80 


MODULE 


“MTRDATAL ° ; 


(* AMZ8001 VERSION *) 


CLOBAL BUFLEN, BUFFER; 


SEGQVENT “DATA‘’ ; 


BYTE 


BYTE 


SEGQVENT [facov], 


(5); 


CALL BLOCK: 


WORD 


END. 


(Z)8 


(80); 


“CALLBLK’ ; 
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MACZ B:MTREXIT1 S O L=B:MTREXIT1.PRN . © 
MTREXIT1 | — 
0000 7 
0000 MODULE ‘’MTREXIT1’; 
0000 | 
0000 (* AMZ8001 VERSION *) 
0000 
oo00 GLOBAL EXIT; 
0000 
0000 SEQVENT ‘CODE’; 
0000 EXIT: | 
0000 TFA SC 161; 
0002 | 
END. 


0002 


eX 
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( MACZ B:MTRREADI S O L=B:MTRREAD1.PRN 

| MTRREADI 
0000 | 
ooo0 MODULE ‘’MTRREAD1’; 
0000 
0000 | (* AMZ8001 VERSION *) 
oooo 
ooo0 GLOBAL READ; 
oooo 
ooo0 ~ EXTERNAL BUFLEN, BUFFER; 
NANA 
oo00 SEQVENT ‘CODE’; 
Oooo READ: 

: 0000 (* SET UP CALL BLOCK *) 

4 oooo 4D05So0005 OQaDOD LD CALL BLOCK, #0100; 

0006 0100 ~ 
0008 4D05S0005 0002 LD CALL BLOCK(2), 0; 
OO0E oooo = 
0010 140250003 OO000 LDL RR2, “BUFFER; 
0016 5D02S0005 0004 PL. CALL BLOCK(4), RR2; 
001C 4D05S0005 0008 LD CALL BLOCK(8), 80; 
0022 0050 7 
0024 (* SET UP POINTER *) 
0024 1402S0005 oo00 LDL RR2, “CALL BLOCK; 
002A 7FO00 SC 0; 7 
002C (* GET, ADJUST, SAVE COUNT *) 
002C 610350005 0008 LD R3, CALL_BLOCK(8); 
0032 AB30 DEC R3, 1; 
0034 6F03S0002 OO0D LD BUFLEN, R3; 
003A 9E08 RET; 
003C 
003C SEQVENT [@COM], ’CALLBLK’; 
ooo0 CALL BLOCK: 
0000 WORD (5); 

q OOOA 

% OOO0A END. 


(— 
a, 


MACRO8 000: Version 2.0 9/19/80 
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MTRWRIT1 

0000 

0000 MODULE ‘’MTRWRITI’; 

0000 

0000 (* AMZ8001 VERSION *) 

oo00 | 

0000 GLOBAL WRITE; 

0000 

0000 | EXTERNAL BUFLEN, BUFFER; 
oo00 

0000 SEQVENT ‘CODE’; 

0000 WRITE: 

ooo0 (* SET UP CALL BLOC *) 
0000 4D05S0005 oo000 LD CALL_ BLOCK, #0200; 
0006 0200 

0008 4b05S0005 0002 LD CALL _BLOCK(2), 0; 
OO0E 0000 

0010 1402S0003 ooO0 LDL RR2, *BUFFER; | 
0016 5D02S0005 0004 LDL CALL _BLOCK(4), RR2; 
oo1C (* ADD CR/LF AT END OF BUFFER *) 
oo1C 6103S0002 OO00 LD R3, BUFLEN; 

0022 ##C8s0D LDB RLO, #0D; 

0024 #7228 0300 LDB RR2*(R3), RLO; 
0028 A930 INC R3, 1; 

002A C80A LBB RLO, #0A; 
~002C 7228 0300 L_DB RR2*(R3), RLO; 
0030 (* STORE ACTUAL COLNT *) 
0030 A930 | INC Roe 2s 

0032 6F03S0005 0008 LD -CALL_BLOCK(8), R3; 
0038 (* SET UP POINTER *) 

0038 1402S0005 oOoO00 LDL RR2, *CALL_ BLOCK; 
O03E 7F 00 SC 0; 

0040 9E08 RET; 

0042 ; 2 
0042 SEGVENT [@COM], ’CALLBLK’; 
0000 CALL BLOCK: 

0000 WORD (5); 

OOO0A 

OO0A END. 
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CHAPTER 6 
MODULE CREATION 


This chapter contains a sample MODULE run. Module creation is used for 
incremental linking, where the linking operation is done is done in two 
or more steps. Typically, selected program parts are linked together in 
a MODULE run that produces a combined relocatable module. The combined 
module is then used in a later linking operation as part of the 
relocatable input. The last step is a PROGRAM run that produces 
absolute code suitable for downloading. 


pabec Le ERL 
OcLNKZ x O=L.NKMOD << perked 


LINKB000% VERSION 2.0% 10/13/80 
wes MODULE 'MONLTOR 


wees HEADER 'COMEINED RELOCATABLE ' wepe* 
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ENTER MODULES MTRDATA <— eRe fer 
ENTER MODULES MTREXIT 4 

ENTER MODULE? MTRREAD 

ENTER MODULE? MTRWRIT 
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- CHAPTER 7 
{ LIBRARY CREATION 


This chapter contains a sample LIBRARY run. A number of program parts 
are collected into a library. The relocatable library is then used to 

satisfy externals in a PROGRAM run that produces absolute code suitable 
for downloading. 


porns aa 
ABoOLINEZ OK Osh NE LICE <— aie a 


LIINKB000 3 VERSION 240% 10713780 
mez LICBRARY ‘MOND TOR | 


4 ame HEADER "STANDARD LIBRARY ' 
ee FILLE MTOR! pr hi 
at polecatebhe 0~ 
sam. MAAR CS BRL fier 


BUF ERS MTKDAT A 
i LEN MTRDAT 
ALT MTRE XT 
READ MTRREALD 
WROTE: MTRWRCDT 
neem TIN 


ASTYRE LNKLIE. ZR e——— Py Libr | 


LICERAR YS MONITOR 


STANDARD LCERARY pad fir 8 Sead 
ASLNKEZ Ok Eb=LNKLIE << +~ 


LINKS8000 VERSYON 2.60» 10713780 
me PROGRAM START 
ame OF TLE ESUESK ! 


: ENTER MODULE! BUBEXE® <—— ak pele 


ENTER MODULES BURRRET 


ENTER MODULES EBURSORT 


5 La EX TERA AL 


pure 


. see Cs Ma \-* ppg ° 
BUEE ER EXTERNAL. pLowrg 


es Oe EXTERN AIL. 


ROME TE VOU Ox UE RET CODE: 
REAL KA TERNAL 
SOT O00 Oe UE SORT eCODE: 
mo PART QO000x RUE XE (CODE. 
WRT: EXTERN All. 


mal SEARCH LINK LOOCES 


ENTER LOERARCY ¢ 
ENTER MODULE 
ENTER MODULE 
ENTER MODULE 
ENTER MODULE 


ry - oo 
eeenece “eo. ‘ate of 8 
teee eee oe i im [-- 


or 


oS $2 $2 


MONT TOR 


MTRDATA 


MTREXET 
MTRREAD 
MTRWELT 


BUFFER v002« 
ISUFLIEN N00 0x 
EXIT vO00%« 
PR OMET 0000% 


hk AD 
UR T 
START 
WROTE: 


DOU (xe 
OOO OX 
OOO Qa 
0 0) Qac 


MT RDATA 
MTRDATA 
MTR AT 
UES herb T 
MTRRE AD 
RUE Skee 
EUIEEDXEC 
MURWEIDT 


DATA 
e LENT ey 
CODE: 


alODE 


CODE 
ODE: 
eo COW E: 
eCODE: 


a 


a AS SOLUTE oOo 
ama (COMICON URE AEC 


<< gate pyc Durk poder 


STESsaeOM bo fh 8 te 


BUFFER uo02*« 
SUF LEN g000% 
EXIT vO00Xx 
PR OMET 000% 


READ VOU 


SORT 
oe 

ARTE: 

seats COMESLNE 
2 MAP 

BUFFER 

BUFLEN 

EXIT 

ER CMET 

READ 

SORT 

START 

WRITE 


me MAR OEY MODULE 


Isis AR 


eS EAE 
WNIT Sf 


Esk Re Ty 


UR eT 
WNIT So 


IS ORT 
UE SORT 


UNIT SIZE 


MTRDAT eA 


0) 0) Qe 


we O 


OO O« 


<—$—gretgn~ othr pote 


SLA 
a ee 


eas aa 
ad A. he rt 


eK: 


ooge gece 

eee 

Lt: eee 
20 Seee 


CODE 


re 


eCODE 


eaee 
coe 


Zk. 


OOK: 


00-40 


OO 3k 


MTR DA TA > CALL ESLR 


MURDATA. DATE 
WNIT Si 


oe ge gece 
?' |: 
roe Seoe 


OOS 


MTRDATA 
MTEDATA 
MTREXET 
BUBFRET 
MTRREAD 
BUESORT 
BUBEXEC 
MTRWRIT 


MTRDAT A 
MTRDATA 
MTREXIT 
cd Wo ed oad 
MiTRRKE ela 
LES Scere T 
REE EC 


MT RWELT 


OGLE 


o04T 


0 O33 


VO08 
0 O27 


oDATFY 
eDAT ES 
«CODE: 
eODE: 
«CODE: 
CODE 
» CODE 


2 CODE 


DATA 


een tes 


oC CHOK: 


oC ODE: 
eC ODE. - 
oD E: 


ACODE 


ODE 


wt FA 


ELA 
Sa LAR 


MTR ACT 
MTRE IT. CODE: O00 aa 
UNOT Sci = OOO 
MTN EAL 
MTR READ . CAL LIESLIK 00s wh Aad 
MTR REAL «CODE: O02 we F be. 
UNITY S22 = O02C 
TRAE OT 
MTRWROOT 6 CALL VOUS wh Ad 
MTR WRT OOH k: 0 C34 ne Sl 
UNIT S202 = O04 
' TOTAL FROGRAM SIZE = COL SHE 
mam ENT 
LOAD MODULE ¢ 
LOAD MODULE? BURR T 
LOAD MODULE ¢ EES Obs T 
LOAD MODULE: MTRDATE 


Flee XE 


LOAD MORULE ? MTRE ACCT 
LOAD MODULE © MPR OALS 
LORD MODULE ¢ MTRAR OT 


file. LNKLIB. BIN Can 


io 
A 
ie 
ars 
ith 
X 
" 


CHAPTER 8 
ROMLIB CREATION 


This chapter contains a sample ROMLIB run. A ROM library can be created 
as additional output from a PROGRAM run. The R or R=file option must be 
used on the LNKZ product call, and the RETAIN or OMIT directive may be 
used to specify a subset of entry points for the ROM library. 


‘ The absolute code referenced by the ROM library is a hex file that is 
burned into PROMs. The ROM library itself remains as a file that can be 
combined with other ROM libraries and used in a later’ linking 
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APPENDIX A 
( ASCII CHARACTER SET 


The ASCII character set is shown in the following table: 


TABLE A-1. ASCII. 
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APPENDIX B 
HEX FILE FORMAT 


The linker can produce hex files suitable for putting code into PROMs. 

Hex file creation is requested with the LINK8000 H option, described in 

chapter 1. The format of a hex file is the INTEL hex file format: 
Colon, 1 character 


Data length, 2 characters (00 for final record) 


Record address, 4 characters (in final record, specifies entry 
| point) 


Relocation map 


| 
| 
| 
| 
| 
| 
| Data, 2 through 32 characters representing 1 through 16 
| byte values (empty for final record) 

| 

| Checksum, 2 characters 


CR/LF (carriage 
| return/line feed) 
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| 
| 
| 
| 
| 
| 
| 
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APPENDIX C 
BINARY FILE FORMAT 


The linker can produce binary files suitable for program downloading or 
PROM burning. Binary file creation is requested with the LINK8000 B 
option described in Chapter 1. The AMC binary file contains the same 
type of information as that found in hex files, but the data is in the 
more efficient hexadecimal representation. 


Each binary file contains a main entry point group, a destination 
address group followed by one or more data groups, any additional 
destination address groups, each followed by one or more data groups, 
and finally a terminator group. The format of each group is described 
below for both processors. 


C-1. AmZ8002 BINARY FILE FORMAT 


Ol signal for main entry point, l byte | 


-_ 


| Main entry point (transfer) address, 2 bytes 
| | 

VV 
Ol) | 


02 signal for destination address, 1 byte 
| 

| Destination address for following data, 2 bytes 
| | 

VV 

[02 | | 

03 signal for data, 1 byte 


Data length, 1 byte 


Data, 1 through 255 bytes 


eee 


| 
| 
| | 
| | 
| | 
VV 


a ee y 
103] | l | 


OO signal for terminator, 2 bytes 
| 


V 
|O000| 

{™ 
For AmZ8002 extended space groups (see section 3-18), the signals are QU 


as follows: 


09 signal for main entry point (1 byte) 
OA signal for destination address (1 byte) 
OB signal for data (1 byte) 
0000 signal for terminator (2 bytes) 


C-2. AmZ8001 BINARY FILE FORMAT 


The AmZ8001 binary file format is very similar to the AmZ8002 format, 
except for the address representation and the actual signal numbers. 
The addresses in AmZ8001 binary files have the same format as AmZ8001 
32-bit address operands: 


a 


| | | | 
bits 31 23 15 0 
contents 1 segment 00000000 offset 


O5 signal for main entry point, 1 byte 


Main entry point (transfer) address, 4 bytes 


105! 

O06 signal for destination address, 1 byte 
| . 

| 


Destination address for following data, 4 bytes 


O7 signal for data, 1 byte 


Data length, 1 byte 
| 


| 
| 
| 
| | Data, 1 through 255 bytes 
| | | 
VV OV 


——aeee eee 


|O71 | | 


OO signal for terminator, 2 bytes 


|OO000| 


: For AmZ8001 extended space groups (see section 3-18), the signals are 
as follows: 


OD signal for main entry point (1 byte) 
OE signal for destination address (1 byte) 
OF signal for data (1 byte) 
0000 signal for terminator (2 bytes) 


C=3 


APPENDIX D 
ERROR MESAGES 


The LINK8000 error messages are error description rather than error 
numbers. The following messages exist. 


RELATIVE ADDRESS OUT OF RANGE: 
ODD ADDRESS BOUNDARY DETECTED: 
: UNDEFINED LABEL: 
UNDEFINED MACRO: 
INVALID NUMBER OF OPERANDS: 
INVALID FILE NAME: 
STRING TOO LONG: 
MISSING OR INVALID IMMEDIATE (CONSTANT) OPERAND: 
SYSTEM ERROR 
IMMEDIATE OPERAND TOO LARGE: 
PRODUCT CALL OVERRIDE: 
DIGIT EXCEEDS RADIX 
RADIX EQ 0 
MISSING ( 
RADIX TOO LARGE 
TOO MANY INVALID CHARS 
INVALID NUMBER FORMAT 
MISSING OR INVALID OPERAND: 
MISSING ) 
MISSING ] 
INVALID LABEL IDENTIFIER: 
UNRECOGNIZED STATEMENT FORM: 
INVALUD LOCATION COUNTER RESET: 
MISSING END 
MISSING : OR ( 
MISSING OR INVALID STRING 
MISSING OR INVALID CONST OBJECT 
MISSING = 
INVALID IN MACRO BODY OR CONDITIONAL LINK 
MISSING OR INVALID INTEGER 
INVALID MACRO STATEMENT 
MISSING OR INVALID IDENTIFIER 
REDEFINITION OF IDENTIFIER: 
DIVISION BY 0 
; UNRECOGNIZED STATEMENT FORM: 
MISSING DELIMITER: 
INVALID DEFINITION 
UNDEFINED EXPRESSION: 
MISSING CONDITION CODE: 
MISSING END. (OR EXTRA END) 
INVALID STATEMENT BEGINNER: 
MISSING STATEMENT TERMINATOR: 
MISSING OR INVALID LINKING MODE (PROGRAM,MODULE, ETC.) 
( INVALID CHARACTER: 


MISSING OR INVALID SEGMENT ATTRIBUTE SET: 


MISSING OR INVALID SEGMENT NAME: 

SEGMENT STACK UNDERFLOW 

SEGMENT STACK OVERFLOW 

STATEMENT INAPPROPRIATE TO LINKING MODE 
INVALID ASSIGNMENT: | 

SHORT ADDRESS OFFSET TOO LARGE 

FATAL ERROR — LINK TERMINATED 

FILE STACK ERROR 

ERROR IN EXTENDING FILE - 

FILE SPACE OVERFLOW - 

DIRECTORY OVERFLOW 

FILE CLOSE ERROR - 

ATTEMPT TO READ UNWRITTEN DATA - 

ATTEMPT TO READ BEYOND EOF - 

UNABLE TO OPEN INPUT FILE - 

OBJECT SPACE OVERFLOW 

ILLEGAL SYSTEM FUNCTION (message should never appear) 
DEREF SYSTEM ERROR: (message should never appear) 
ATTEMPT TO COMPUTE ADDRESS DIFFERENCE 

ACROSS SEGMENT BOUNDARY AT 

ATTEMPT TO COMPUTE RELATIVE ADDRESS 

ACROSS SEGMENT BOUNDARY AT 

PHASE III ERROR 

RELATIVE ADDRESS OUT OF RANGE: 

ODD WORD BOUNDARY DETECTED: 

UNDEFINED LABEL: 

UNDEFINED EXTERNALS: 

NORMAL TERMINATION 

INVALID OPTION(S) 

EMPTY INPUT FILE 

INVALID OPTION(S) 

ROMLIB NOT PERMITTED: 

RELOCATABLE MODULE NOT ALLOWED IN ROMLIB EDIT: 
DUPLICATE ENTRY POINT: 

MISSING COMMON ATTRIBUTE: 

WARNING: CURRENT ADDRESS + SEGMENT SIZE > 64K 
RETAIN (OMIT) PATTERN STRING: 

WARNING — "COMMON" SEGMENT SIZE ERROR: 
PATTERN SPECIFIED COMBINE: 

MAP VECTOR OVERFLOW 

INVALID MODULE/SEGMENT SPECIFICATION (COMBINE) 
INVALID ARGUMENT (RETAIN OR OMIT) 
UNIDENTIFIED ENTRY 

BINARY FILE RQRD -- Z8001 PROGRAM MODE 
DUPLICATE ENTRY POINT: 

MIXING SEGMENTED AND UNSEGMENTED MODULES PROHIBITED: 
DUPLICATE ROMLIB LABEL: 

DUPLICATE LIBRARY LABEL: 

DUPLICATE MODULE NAME: 

DUPLICATE LIBRARY MODULE: 

UNABLE TO OPEN FILE: 

INVALID MAP DIRECTIVE: 

INVALID FILE DIRECTIVE (LIBRARY MODE) 

COMBINE DIRECTIVE NOT ALLOWED 


a 
| 
‘ ) 
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